home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 2 / ETO Development Tools 2.iso / Essentials / Developer Essentials Nov 90 / Apple II / Apple.II.partition / Utilities / rTutors / part3.3 / Read.Me next >
Encoding:
Text File  |  1990-08-19  |  3.6 KB  |  76 lines  |  [p?/pdos]
  1.                  rTutor.S16 - The Resource Tutorial Application
  2.                                   version 3.3
  3.              (This time around, we explore icons and custom cursors)
  4.  
  5.  
  6. This "Read.Me" file is a SHORT summary of what's new this time around and
  7. how to build the application from its source code.  More detailed information
  8. will be available seperately (once I write it) in the form of "Rez 105" - the
  9. fifth installment in my on going detailed docs for the resource tutorial.  As
  10. I write this, only Rez 101 and Rez 102 have been done so far.  I still need
  11. to do Rez 103 and Rez 104 before I do Rez 105, so don't hold your breath - it
  12. takes a lot of time to do some of this stuff...
  13.  
  14. The APW C source file "rTutor.C" and the Rez source file "rTutor.Rez" together
  15. create an application that starts up all needed tools from a list in
  16. the application's resource fork, installs a menu bar in that application, and
  17. opens a window (with icons in it) from the resource fork.  The menu bar and
  18. all of the menus in that menu bar are also stored in the resource fork of the
  19. application.  The icon in the window is also kept in resources so you can
  20. change the "look" of the window and menus using only resource editing tools
  21. such as DeRez/Rez (from APDA) or GeneSys (from SSSi).  The standard pointer
  22. cursor has been changed to a pig face just to show how custom cursors are
  23. created in resources and how to use them from within your applications.
  24.  
  25. Compiling the Rez source code requires the Rez compiler which can be purchased
  26. from either "Developer Tools Express" or from "APDA" (Apple Programmers and
  27. Developers Association).  Rez, along with a number of other resource tools and
  28. APW utilities can be ordered by calling APDA (it's the same phone number for
  29. "Developer Tools Express" - the only difference is that you do NOT have to be
  30. an APDA member to order from Developer Tools Express) at:  1-800-282-2732.
  31. These tools are part of the product named "APW Tools & Interfaces v.1.1",
  32. the price is fifty dollars.  The part number for this package is "A0240LL/A".
  33.  
  34. Three other tools from that package are also used to build this resource
  35. tutorial application.  These tools are "duplicate" (which copies files without
  36. losing their resource forks like the regular COPY command currently does) and
  37. LinkIIGS.  If you use the original APW linker or ORCA's original linker, please
  38. be sure to add (at the END of all other lines) the two lines:
  39.  
  40. COMPACT rTutor.S16 -o rt.comp
  41. EXPRESS rt.comp -o rTutor.S16
  42.  
  43. These steps are NOT needed if you're using The Byte Works, Inc's new "ZapLink"
  44. since it automatically does the equivalent of COMPACT and EXPRESS, just like
  45. LinkIIGS does.
  46.  
  47. To create the application, issue the following command from the APW/ORCA
  48. shell's command line:
  49.  
  50. rTutor.Make
  51.  
  52. Everything else is taken care of by this EXEC script.  If you want to see how
  53. the rTutor application is built, simply TYPE or print the rTutor.Make file.
  54.  
  55.  
  56.  
  57.  
  58.  
  59. enjoy!
  60. Tim S.
  61.  
  62. I can be reached on the following networks for questions, info, request, etc.
  63. Please be sure to check the general forums there first since you're more likely
  64. to get a fast answer in the public forums than via email.
  65.  
  66. GEnie:  Tim.Swihart (post in A2Pro first)
  67. America Online: A2Pro Tim    (post in ADV first)
  68. AppleLink  Tim.Swihart  (post on GEnie or America Online first)
  69.  
  70.  
  71. p.s.->  Cursors are a PAIN!  And their masks are even worse!  The pig face has
  72. a square mask (because I was tired of futzing with it).  If you're looking for
  73. a way to explore cursors, then I suggest you tackle the problem of making the
  74. mask for that cursor work better.  By the time you're done, you'll be VERY
  75. familiar with cursors...  <grin>
  76.